home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / mus / play / dmdev.readme < prev    next >
Text File  |  2002-11-06  |  4KB  |  140 lines
  1. Short:  Mpeg.device for Delfina DSP
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/play
  4.  
  5. $VER: delfinampeg.device 1.5 (Sun 03-Nov-2002)
  6.  
  7.  
  8.  
  9. #features
  10.  
  11.   -plays MPEG audio files with almost no CPU load
  12.    (Delfina's DSP56002 does all the decoding and playback)
  13.  
  14.   -supports MPEG-1 layer II and III
  15.  
  16.   -standard "mpeg.device" API
  17.    (code based on melodympeg.device by Thorsten Hansen)
  18.  
  19.   -free software
  20.    (full source code included, of course)
  21.  
  22.  
  23.  
  24. #requirements
  25.  
  26.   -CPU 68020+
  27.   -AmigaOS V37+
  28.   -Delfina DSP board
  29.  
  30.   -developed on A1200 - OS3.1/68030+882@40MHz/16MBFastRAM/Delfina1200DSP
  31.   -tested on various machines with Delfina1200, Delfina Lite or Plus
  32.  
  33.  
  34.  
  35. #recommended
  36.  
  37.   -application that uses mpeg.device (such as AMPlifier, Frogger and others)
  38.   -some MPEG audio files :)
  39.  
  40.  
  41.  
  42. #changes since previous release
  43.  
  44.   -mp3 decoder: tiny speedup; uses less DSP memory; output level corrected
  45.   -mp2 decoder: output level corrected
  46.  
  47.  
  48.  
  49. #how to use
  50.  
  51.   Copy delfinampeg.device to your "devs:" drawer.
  52.   Configure an application program to make use of it, for instance:
  53.  
  54.   AMPlifier    http://www.katodev.de
  55.       Configuration -> Audio I/O -> MPEG audio player -> Decoder
  56.       MPEG device:    delfinampeg.device
  57.       Unit:           0
  58.       Buffersize:     128 (recommended)
  59.       Blocksize:      16  (recommended)
  60.       set Layer I/II and Layer III to "Hardware" decoding
  61.  
  62.   Frogger      http://frogger.rules.pl
  63.       use the option ADECODER with mode DELFINA
  64.  
  65.   AmigaAMP     http://www.amigaamp.de
  66.       get the "MHI driver for mpeg.device" from Aminet: mus/play/mhimdev.lha
  67.       follow the installation instructions in the README file
  68.  
  69.   Especially owners of the slower Delfinas (i.e. Lite) might be interested
  70.   in the configuration options of delfinampeg.device, which can be used to
  71.   sacrifice some playback quality in order to reduce DSP load. The device
  72.   reads them from the environment variable DELFINAMPEG during OpenDevice().
  73.   The options are:
  74.  
  75.   L2MONO...........mp2 files: decode left channel only
  76.   L2RATE <number>..mp2 files: play at specified rate (given in kHz)
  77.   L3MONO...........mp3 files: decode left channel only
  78.   L3RATE <number>..mp3 files: play at specified rate (given in kHz)
  79.  
  80.   The given playback rate is automatically rounded to the nearest available
  81.   Delfina rate (16, 27, 32, 48 kHz; Delfina 1200/Plus: 12, 24, 36, 48 kHz).
  82.   example:
  83.   > setenv DELFINAMPEG l3rate 32
  84.     (play mp3 files at 32 kHz)
  85.   > copy ENV:DELFINAMPEG ENVARC:
  86.     (save settings to disk)
  87.  
  88.  
  89.  
  90. #known problems
  91.  
  92.   -delfinampeg.device only recognizes MPEG-1 audio files.
  93.    not supported: MPEG-2 or mixed audio/video files.
  94.  
  95.   -please read the README for DelfMPEG (Aminet: mus/play/DelfMPEG.lha)
  96.    in the "known problems" you find a list of bugs in the official Delfina
  97.    drivers (delfina.library).
  98.  
  99.   -equalizer and visual effect plugins of AMPlifier are currently not
  100.    supported. this is not a feature of the mpeg.device. AMPlifier needs to
  101.    copy the decoded audio data back from the sound board to main memory,
  102.    which it can only do with the Melody boards but not (yet) with Delfina.
  103.  
  104.  
  105.  
  106. #acknowledgements
  107.  
  108.   delfinampeg.device uses ideas/code from:
  109.  
  110.   -MPEG Audio Layer II decoder by Fredrik Noring and Tomas Berndtsson
  111.    (an mp2 player for Atari Falcon, DSP56K code)
  112.   -amp11 by Niklas Beisert (clean and fast C++ code)
  113.   -FalcAMP by Denis "STGhost" Huguet and David "Splash" Carrere
  114.    (an mp3 player for Atari Falcon, DSP56K code)
  115.   -reference code by MPEG Software Simulation Group ("the original" C code)
  116.   -melodympeg.device by Thorsten Hansen
  117.  
  118.  
  119.  
  120. #author
  121.  
  122.   mailto: smack42@web.de
  123.  
  124.   delfinampeg.device - mpeg.device for Delfina DSP
  125.   Copyright (C) 2000-2002  Michael Henke
  126.  
  127.   This program is free software; you can redistribute it and/or modify
  128.   it under the terms of the GNU General Public License as published by
  129.   the Free Software Foundation; either version 2 of the License, or
  130.   (at your option) any later version.
  131.  
  132.   This program is distributed in the hope that it will be useful,
  133.   but WITHOUT ANY WARRANTY; without even the implied warranty of
  134.   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  135.   GNU General Public License for more details.
  136.  
  137.   You should have received a copy of the GNU General Public License
  138.   along with this program; if not, write to the Free Software
  139.   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  140.